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THE TROP USER MANUAL CONSISTS OF THE FOLLOWING SECTIONS: 


SECTION 1. TROP INTRODUCTION 
SECTION 2. TROP GENERAL USE DOCUMENTATION 
SECTION 3. TRDP UPDATE PROGRAM (UPD2TR) 


SECTION 1. TROP INTRODUCTION 


TABLE OF CONTENTS 


WHAT IS TROP 

TROP REQUIREMENTS 
DISCLAIMERS 

CONTENTS OF A TROP PACKAGE 
THE TROP PACKAGE 

WHAT IS TROP 


TROP IS A NAME FOR A PDP-11 DIAGNOSTIC PACKAGE AVAILABLE 
cies eOIA, » INCLUDES TR7SF DIAGNOSTIC PACKAGE (9 TRACK 


afew yp 


THE TROP PACKAGES CONTAIN PDP-11 FAMILY DIAGNOSTIC PROGRAMS ON 
MEDIA OTHER THAN PAPER TAPE. TROP PACKAGES HAVE THE FOLLOWING ADVANTAGES: 


PROVIDED FOR UPDATING AND MODIFYING PROGRAMS. 
POSSIBLE TO SEQUENTIALLY RUN A SERIES OF PROGRAMS THROUGH USE 
OF THE “CHAIN MODE” FEATURE. (PROGRAMS MUST BE CHAINABLE). 


A. MED 
e- EASY AND CONVENT! MEANS OF LOADING Bass ak | UNDER KEYBOARD CONTROL. 
x MEANS 


ALL TROP PACKAGES REQUIRE: 


A. PDP-i1 PROCESSOR WITH AT LEAST 16K STORAGE. 
B. CONSOLE DEVICE 
C. TR79F DIAGNOSTIC PACKAGE MEDIA: 


THE ABOVE REQUIREMENTS ARE FOR LOADING AND RUNNING DIAGNOSTIC PROGRAMS 
ALREADY STORED IN THE DIAGNOSTIC PACKAGE MEDIA. THEY ARE ALSO 
SUFFICIENT FOR IMPLEMENTING PERMANENT PATCHES ON PROGRAMS WHEN REQUIRED. 


SEQ 0002 


2.2 


2.3 


3.1 


3.2 


VERSTONS OF ? BAOGRARS Tor THe PACKAGE, the RRA % REQUIRED: 


A. PC11 HIGH SPEED READER, OR 
B. ASR 33 OR ASR 3S TELETYPE. 


OPTIONAL HARDWARE : 
A. TSTRAP FOR_THE TR7SF 
FT nAKES LOADING THE TROP MONITOR MORE CONVENIENT. 


DISCLAIMERS 


WARE 
DOCUMENT ARE NOT SUPPORTED. 


THE TROP PACKAGES ARE BINARY PACKAGES ONLY. 
FAMILY DIAGNOSTIC PROGRAMS IN THE 
FOR EACH OF THE PROGRAMS STORED 


mgee 
& 
BS 


SEPARATELY, FROM SOFTWARE DISTR 
DOCUMENTAT LON MUST T Be OBTAINED A 
ORDER TO INSURE THAT THE DOCUMEN 
REVISION LEVEL. 


CONTENTS OF A TRDP PACKAGE 


THE BASIC PARTS OF A TROP PACKAGE ARE: 
A. A CONTROL PROGRAM REFERRED TO AS THE “MONITOR”. THE MONITOR + whens 
THE MEANS TO LOAD PROGRAMS UNDER KEYBOARD CONTROL, TO OBTAIN 
DIRECTORY OF CONTENTS OF THE TROP MEDIUM (DECTAPE, MAGTAPE, ETC). 
B. ag UPDATE PROGRAM #2 (UPD2TR). A &.SK PROGRAM THAT PROVIDES A MORE COMPREHENSIVE 


OF COMMANDS THAT PROVIDE MORE CONVENIENCE AND EASE OF UPDATING 
THE TROP PACKAGE. 


THE TROP PACKAGE PROVIDES THE PDP-11 FAMILY DIAGNOSTICS ON 9 
TRACK MAGTAPE (TR7SF). THE PACKAGE CONSISTS OF THE FOLLOWING ITEMS 
THAT MUST BE ORDERED INDIVIDUALLY: 

MAINDEC-11-DM@XA TROP USER MANUAL (THIS DOCUMENT). 


MAINDEC-11-DMZZH-A-MBS TROP-TRDP TR79F DIAGNOSTIC PACKAGE (9 TRACK). 


1.4 


1.4.1 


SECTION 2. TROP GENERAL USE DOCUMENTATION 


1 LOADING PROCEDURES 

1.1 LOADING TROP MONITOR 

2 USE PROCEDURES 

2.1 SETTING THE CONSOLE FILL COUNT 
2.2 OBTAINING A DIRECTORY 

2-3 LOADING AND RUNNING PROGRAMS 
5-41  GHAIN PROBREM eC 

2.4.2 MAKING A CHAIN 

2.4.3 RUNNING A CHAIN 

3.1 TROP RESIDENT MONITOR ERRORS 


APPENDIX A. TROP RESIDENT MONITOR COMMANDS 


LOADING TROP MONITOR 


THE TROP MONITOR CAN . LOADED BY BMBS873-S1, 
OR VIA A “TOGGLE-IN” 
THE TOGGLE-IN PROCEDURE IS ONLY VALID FOR THE TR7SF. 


VIA BOOTSTRAP LOADER 


A. TE een TAPE ON DRIVE 0 AND MAKE READY. 
B. REWIND IVE 0 TO “BOT” AND SET “ON-LINE” 

C. LOAD BMB873-S1 STARTING ADDRESS 173540 

D. PRESS START 

E. GO TO 1.4.3 STEP A. 


E01 


SEG 0004 


1.4.2 VIA “TOGGLE-IN” PROCEDURE 


STARTI 
WAIT UNTILL DRIVE 
LOAD ST 


10000 012700 164000 
Has Be te 
: B00 OL 16 
10022 Bourg? 010116 
10026 005011 

10030 tagt 

10032 012710 000005 
10036 004737 010116 
10042 032711 000020 
1 005011 

10050 12710 000005 
10054 004737 010116 
1Doee 1041 

10064 bis7i3 174000 
10070 1 


aiorie 


= 
= 


1 

101 

10104 112524 

10106 005205 

10110 020513 

iRitG 

10114 

10116 032710 000200 
ities ata , 
0133 | ora SOON 
10132 032711 011000 
10136 001001 

10140 0900000 

10142 000207 


THE MONITOR IS LOADED FROM MEDIUM 


MOUNT Pg ee pe A RB af 
REWIND DRIVE 0 TO “BOT” AND SET “ON-LINE”. 
DRIVE SHOULD BE @ LOAD PIONT 

N PROGRAM 


NG. ADDRESS AT LOCATION 10000 


START: 


BURST: 


REED: 


READY: 


TAPERR: 


RTN: 


MOV 
MOV 


MO 
RESET 


FOL 


ILL & CPU HAL 
ART T ADDRESS AT LOCATION ZERO (0) PRESS START KEY 


SRST BESTE STS 
AD win 
a8 G2 yas 
E 


BRR? 
Re y 
a + 
2 


#200, JRO 


B. THE MONITOR TYPES THE FOLLOWING MESSAGE AND IS THEN READY 
OMMANDS . 


TO ACCEPT KEYBOARD C 


SEG 0005 


2.1 


2.2 


GO1 


XXXXX-K TROP - TR79F MONITOR NNK RESTART: XXXXXX 
(HELP MESSAGE) 


WHERE: NNK IS THE SYSTEM’S STORAGE UP TO 28K 
MONITOR’S RESTART ADDRESS. 


S 
THE DOT (.) INDICATES THE RON; TOR IS READY TO ACCEPT COMMANDS. 


C. THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C. 
D. GO TO SECTION 2. USE PROCEDURES. 

NOTE: <CR> MEANS PRESSING THE “RETURN” KEY ON KEYBOARD. 
USE PROCEDURES 


THE USE PROCEDURES THAT FOLLOW APPLY TO TROP 


SET THE FILL COUNT 

THE TTY OUTPUT ROUTINE OF NORMALLY OUTPUTS 

it FILLER oo AFTER A ROTA Fe TUR in ORDER TO INSURE 
T THE LA3OS TERM teen 

THAT THE LA3OS THE FILLER CHARAC 


GON eon ey Te RSE Oe FLL Gann OUTPUT cn 


BE THE FIRST. COMMAND ISSUED IN ORDER TO PROPERLY SET uP THE THE CONSOL. TYPE: 
F<CR> 
oooc14 1 ; THE 000014 IS TYPED a 


RGIS HE GET E IAPR lt ob 


OBTAINING A DIRECTORY 


TO OBTAIN A DIRECTORY TYPE ONE OF THE FOLLOWING: 


D<CR> TO OBTAIN DIRECTORY ON CONSOLE TERMINAL, OR 

D/F<CR> TO OBTAIN SHORT DIRECTORY ON CONSOLE TERMINAL, 

D/L<CR> TO OBTAIN DIRECTORY ON LINE PRINTER. LINE PRINTER 
MUST BE PRESENT ON SYSTEM. NO CHECK IS MADE FOR IT. 


THE DIRECTORY CONTAINS THE FOLLOWING INFORMATION: 


FILNAM. EXT PROGRAM NAME AND EXTENSION ASSIGNED. .BIN, .BIC, 
.SAV, ARE THE ONLY VALID EXTENSIONS FOR 
“MONITOR USE. 
NOTE: INARY FILE 
BINARY FILE 


SEQ 0006 


LENGTH NUMBER OF BLOCKS USED. DECIMAL NUMBER. (DISK AND DECTAPE). 
START STARTING BLOCK NUMBER. OCTAL NUMBER. (DISK AND DECTAPE). 
DATE DATE WHEN PROGRAM WAS PUT ON MEDIUM. 


SEG 0007 


LOADING AND RUNNING PROGRAMS 


A. T Ee slant, THE ees NAME (UP TO 6 CHARACTERS). DO NOT TYPE THE 
: “THE PROGRAM. TO JUST LOAD THE PROGRAM 
Ths i bt Py: n Ree ONCE L TYPING A “S" 
WILL START THE PROGRAM. 
B. DEPRESS THE CTL AND C KEYS. : 


IF A TYPING ERROR DEPRESS THE CTRL KEYS eT SAME TIME. 
A DOT (.) WILL BE Herp RETYPE * 2B» ORD AE BRD ckan NAME 


C. THE DESIRED PROGRAM IS LOADED, A DOT TYPED, AND, 


THE PROGRAM SELF STARTS IF IT IS SELF STARTING 
THE PROGRAM IS S TROOE Qc 900200 1 NE PROGRAM NAME WAS 
3. : ees eats CREATE COHRAND. T HE PROGRAM est LOADED 


RANUALLY BY TYPING PROGRAM NAME. 


D. TO LOAD ANOTHER PROGRAM AFTER RUNNING THE PREVIOUSLY LOADED PROGRAM, 
RESTART THE MONITOR AT THE RESTART ADDRESS, OR RELOAD THE MONITOR 
AS DESCRIBED IN SECTION 1. 


E. POSSIBLE ERRORS ARE DESCRIBED IN SECTION 3. 
CAUTION: BEN LOSING PIS T Its eT a THE TROP 


ME 
INSURE THA UN IS NOT ACCIDENTALLY 
BESTROYED. THAT IS THE REASON THAT THE MEDIUM. MUST 
LOCKED. REMOVE IT IF IT 1S DESIRED 10 TEST THAT DRI 


CHAIN MODE OPERATION 


MODE ornate CONS 


CHAIN tg OF THE SEQUENTIAL EXECUTION OF PROGRAMS 
EME Nee ee ae 4 


PROGRAMS THAT HAVE BEEN MODIFIED 
PROGRAMS ARE 


A CHAIN FILE MAY BE GENERATED BY USING THE XTECO TEXT EDITOR, 
AND THE USER MUST PUT A .CCC EXTENSION ON THE CHAIN FILE. 


I01 


TO SUMMARIZE: 
(.BIC EXTENSIONS). 


—~ ; AEP ie Rt AE EC wba he Se ARN 


CHAIN FILE MUST BE ON THE SAME MEDIUM WITH A .CCC EXTENSION. 
~ NOTE: THE .CCC EXTENSION INDICATES A CHAIN FILE 
CHAIN MODE IS ENTERED BY TYPING: 
C FILENAME<CR> (WHILE IN MONITOR MODE). 
CIS THE "CHAIN" 


N” COMMAND 
FILENAME IS THE VALUE OF THE ASCII FILE THAT CONTAINS THE MONITOR 
COMMANDS TO BE EXECUTED. THE FILE MUST HAVE A “.CCC”EXTENSION. 


2.4.1 MAKING A CHAIN ASCII FILE 


THE CHAIN ASCII FILE MAY BE CREATED BY RUNNING THE XTECO PROGRAM AND 
ota Li. TEXT EDITOR TO CREATE THE ASCII CHAIN Pe. THE ph i 





IN ANY OF THE COMMANDS SUPPORTED UNDER TROP MONITOR. 
IN THE SC I FILE BRE EXECUTED IN THE ORDER IN WHICH THEY ARE 
ENT: AND RUN BA . 
EXAMPLE OF A CHAIN FILE; 
;CPU.CCC 
*THIS CHAIN FILE EXERCISES THE XYZ PROCESSOR WITH T1-T13 
R poAAy 1000 5 RUN i 
R Boca 1800 ? RUN : 
R 1000 *RUN T4 
R DOEA/1000 :RUN TS 
R DOFA/1000 *RUN T6 
Dona’ 1p RUN 18 
R Beart RUN 8 
R DOKA/1 *RUN T10 1000 TIMES<CR> 
R /1 + RUN My 1900 TIMES <CR) 
R 1 *RUN Tle 1000 TIMES<CR> 
L DONA ‘LOAD T13<CR> 
S/1000<CR> “START IT, RUN 1000 TIMES<CR> 
C CPU *RESUBMIT CHAIN FILE AGAI 
2.4.2 ING A CHAIN 


TO EXECUTE A CHAIN FILE THE USER TYPES; 


IN THE FIRST CASE THE PASS COUNT SPECIFIED IN THE CHAIN FILE 
IS USED BY THE TROP MONITOR TO DETERMINE Tee eaeer PASSES TO 


Fore eps AND EACH iY PROGEE SFO EKUTED ORLY Once THE /QV SWITCH 
PROVIDES A SINGLE EXECUTION MODE OF OPERATION OR “QUICK VERIFY”. 


SE@ 0008 


JOl 
THE CHAIN FILE TO BE EXECUTED MUST HAVE AN EXTENSION OF .CCC. 


THE SARe "TROP neDLUN AND MUST BE MOUNTED ON DRIVE 0 OF TROP DEVICE 


WHEN IN CHAIN MODE SWITCH REGISTER OR SOFTWARE SWITCH REGISTER SHOULD BE SET TO OOO000. 


THE TROP MONITOR Ba TYPE EACH COMMAND THAT IT EVALUATES AND THEN 
PROCEED TO EXECUTE IT. 


EXTENSION iT TPES “RENEIL®. THEN TE THE ERROR RESULTED FROM A 


) ONLY, IT WILL CONTINUE ur T THE CHAIN Five COMMAND , 
OTHERMver TERMINATES THE CHAIN OPERATI 


EN TE LST COMO OTVER Ten feo NS Wee non 
THE TROP MONITOR TERMINATES CHAIN AND TYPES A DOT(.) 
READY TO ACCEPT ANOTHER COMMAND FROM THE CONSOLE. 


_iIF L USER WISHES TO TERMINATE CHAIN MODE BEFORE ITS NORMAL TERMINATION 
HE MAY DO SO BY REPEATEDLY TYPING CTL C (tC) AT THE CONSOLE UNTIL 
THE MONITOR ACCEPTS IT AT THE END OF A PROGRAM PASS. 


3. ERRORS 


3.1 TROP RESIDENT MONITOR ERRORS 


INVCMD/SW INVALID COMMAND AND/OR SWITCH. CHECK COMMAND 
JUST GIVEN. 
DEVERR DEVICE ERROR ON EITHER INPUT OR OUTPUT DEVICE. 
. CHECK THAT BurPuT DEVICE IS WRITE-ENABLED. 
EOM END OF MEDIUM. OCCURS DURING Me Det Cem ae 


WHEN THE PROGRAM ATTEMPTS TO INPUT AND THE FILE 
IS AT AN END. SERIOUS PROBLEM. FILE IN STOR- 
AGE IS PROBABLY WIPED OUT. 


INVADR INVALID ADDRESS. MUST BE EVEN WITHIN EXISTING 
LOCORE AND HICORE LIMITS, MUST NOT BE WITHIN 
UPDATE PROGRAM. 


CKSMER CHECKSUM ERROR DURING “LOAD” COMMAND. 

POFLO PROGRAM TOO LARGE TO LOAD WITHIN EXISTING CORE 
* INVNAM INVALID CHARACTER TYPED FOR FILE NAME. 

NEXFIL NON-EXISTENT FILE. IF IN CHAIN MODE 


T Paogay! [0 SE RUN DOES NOT HAVE 
"Bic EXTENSION. 


APPENDIX A. TROP RESIDENT MONITOR COMMANDS 


KO1 


F<CR> SET CONSOLE FILL COUNT. 

D<CR> DIRECTORY ON THE TTY CONSOLE. 
D/F<CR> SHORT DIRECTORY ON THE TTY CONSOLE. 
D/L DIRECTORY ON THE LINE PRINTER. 
D/L/F SHORT DIRECTORY ON LINE PRINTER. 

R COPY STARTS THE COPY PROGRAM. 


R FILENAME STARTS INDICATED PROGRAM. 

L FILENAME LOADS DESIRED PROGRAM. 

S FILENAME STARTS DESIRED PROGRAM WHICH WAS LOADED UNDER "L” COMMAND. 
S ADDR STARTS PROGRAM AT SPECIFIED ADDRESS. 

C FILENAME RUNS DESIRED CHAIN TABLE. 

C FILENAME7QV RUNS DESIRED CHAIN IN QUICK VERIFY. 

E O<CR> ENABLE DRIVE O(TADP) 

E 1<CR> ENABLE DRIVE 1(TADP) 


SECTION 3. TROP UPDATE PROGRAMS #2 (UPD2TR) 


ABSTRACT 

REQUIREMENTS 

LOADING AND STARTING PROCEDURE. 
COMMAND DESCRIPTIONS 

ERRORS 

UPDATING TROP MEDIA 

HELP ASCII REFRENCE FILE 


Pr Tr. Ts 


APPENDIX A. UPD2TR COMMANDS 


SEQ 0010 


> gee a anne ae ae eee 


%.3 


LO 


APPENDIX B. PERIPHERALS SUPPORTED BY UPDATE PROGRAMS 
APPENDIX C. PROGRAM NAMING CONVENTIONS 


ris Ae Pedonire Te us TO"Rob,VBELETE, RENAME, On PATCH PROGRANS ON TROP 


N GENERAL, PROVIDE FILE MAINTENANCE SERVIC 


ET 8 TS ABM 


MASS STORAGE DEVICES. 


LOADING AND STARTING PROCEDURE 


PD2ZTR I VIA THE TROP MONITOR BY TYPING R UPD2TR<CR>. 
ONCE CoABED Ti -outeuTe THE FOLLOWING MESSAGE: 


ee - TROP UPDATE PROGRAM #2 21-FEB-76 
TYPE THE DATE ACCORDING TO FOLLOWING FORMAT: 
DATE: DD-MMM-YY<CR> 


BD IS THE DAY OF THE MONTH MMM IS JAN, FEB, MAR, APR, MAY 
JUN, JUL, AUG, SEP, NTNOV DEG AND’ YY IS BETWEEN 70 AND 99. 


bates CIKE PEL Pnt SDETEGIED AS ERRORS 


THE PROGRAM WILL TYPE BACK THE DATE FOLLOWED BY: 


RELOCATED TO: YYYYYY ; INITIAL ADDR WHERE PROGRAM RELOCATED TO. 
;UPD1 RESTART ADDRESS. 
:%# INDICATES READY FOR KEYBOARD COMMANDS. 


PROGRAM 
RESTART: XXXXXX 


COMMAND DESCRIPTIONS 


IN THE COMMAND DESCRIPTIONS THAT FOLLOW, AN INDICATION IS PROVIDED 
AS TO THE AVAILABILITY OF THE COMMAND UNDER UPD2TR. 


SEQ 0011 


4.2 


4.3 


4.4 


4.5 


MO1 


THE FILL COMMAND (UPD2TR) 


NAL OUTPUT ROUTINE OF THE UPDATE PROGRAM NORMALLY OUTPUTS 


up TEAS At Lami: PBNER eon aes 


Peres aE Be 


FILL<CR> 
000014 1 


soapy i ay peg yeaa estan 
FOR OTHER TERMINALS, SET THE NUMBER TO WHATEVER PRODUCES CORRECT 
PRINTING AFTER A CARRIAGE RETURN, WITHOUT UNDUE DELAY. 


THE “CLR” COMMAND (UPD2TR) 


a iene tore S USED TO CLEAR TO ZEROES ALL CORE STORAGE BELOW 
STORAGE 16 BE ” “ero PRIOR 10 LOADING A PROGRAR ROG ae WREe tate 
CLR<CR> 

THE PROGRAM RESPONDS WITH # 


LOAD COMMAND (UPD2TR) 


THE LOAD COMMAND IS USED TO LOAD FILES STORED IN ABS FORMA 
(FILES WITH EXTENSION val -BIN, .BIC, OR OTHER EXTENSIONS KNOWN 
TO INDICATE ABS FORMAT) 


LOAD DEV: FILNAM.EXT ; COMMAND FORMAT 
IF THE DEVICE HAS NO DIRECTORY, THEN THE FILE NAME AND EXTENSION 
SHOULD BE OMITTED. 


LOAD PR: -USER C TO LOAD FROM PAPER TAPE. 
XFRADR: QO000SO CORE: ooboee 0176 70 ' 


XFRADR: INDICATES THE STARTING ADDRESS OF THE PROGRAM LOADED. IF 
IT IS 000001 OR ODD, THE PROGRAM IS NOT SELF-STARTING. 


CORE: FT NUMBER INDICATES THE LOWEST INTO 
fe Les ee THE RIGHT R INDECATES: es Te Mey roel on 
OADED INTO DURING THE LOAD. THE LEF 
IN EFFECT INDICATE THE CORE LIMITS OF ANE. PROGRAN 


DUMP COMMAND (UPD2TR) 


SEQ 0012 


a me a me 


‘ 
i 
| 


=a eee 


4.6 


5.7 


4.8 





PS PETRY CONTENTS CAN BE WRITTEN TO A TROP MEDIUM IN ABS FORMAT BY THE 


DUMP DEV: FILNAM.EXT ste FORMAT 


rotate eTonts eae oy Old Pons anre AND PROCEEDS TO 


*#DUMP DKO: XXX. BIN ;DUMP PROGRAM ONTO DKO:. CALL IT XXX.BIN 


*#DIR DKO: 

- JAN- 
ENTRY 7 FILNAM .EXT LENGTH START 
XXX -BIN eras ize ODoL72 


panned (uPbeTR) 
ca SELPOSTARTING OR NOT SELF-StAR ing at THE-USER’ S DISCRETION. 


BOO! ooo0so SOn00E 1S THE CURRENT NER ADDRES ROORESS aaee IS THE 


NEW XFR ADDRESS ENTERED BY THE 
NOTE: = ella PROGRAMS ARE PURPOSELY MADE NOT SELF-STeRING. 
THE “START” COMMAND (UPD2TR) . 


THE “START” COMMAND IS USED TO BEGIN EXECUTION OF A PROGRAM IN CORE. 
START<CR> ;USED TO START A SELF-STARTING PROGRAM. 
START ADR<CR>  ;USED TO A START A PROGRAM AT A SPECIFIC LOCATION. 


NOTE: IF THE COMMAND START<CR> IS GIVEN FOR A NON-SELF-START PROGRAM, 
THE PROCESSOR WILL TRAP OUT WITHOUT AN ERROR MESSAGE. , 


THE SAVE COMMAND (UPD2TR) 


THE CONTENTS OF CORE ARE WRITTEN ONTO THE OUTPUT DEVICE AS A SINGLE 
BLOCK OF bara STARTING AT LOC 000000 PROCEEDING TO THE HIGH 
Lint? OF THE PROGRAM IN CORE. THE SAVE COMMAND IN EFFECT ES 

ORE IMAGE” OF THE CONTENTS OF CORE. FOR TROP PURPOSES THE ONLY 
val is ENSION FOR SAVED IS .SAV. 


PLACE CORE Inece OF THE THBP RONTTOR OW GasBeTTE 


ae PACKAGES DO NOT CONTAIN ANY OTHER 
CORE Th TnAGE F 


— ee eee ee ne ee Oe ee ee 


Betis A PROGRAM IS OR IS Ie no? SEL PUSTARTING: Sie ee oF MPR “XFR” IS: 


SE@ 0013 


a 


4.9 


4.10 


B02 


NOTE: .SAV IS A CORE IMAGE FILE. 
SAVE DEV: FILNAM.EXT ;COMMAND FORMAT. 
He DKO: UPDATE. SAV 

IR DKO: 


2-JAN-76 
A FILNAM .EXT este START 
“epee -BIN 2e-U-72 toe mols 
poate .sav  26-AUG-7 ig hast 
ILES: 445 


THE GET COMMAND (UPD2TR) 


THE GET COMMAND PLACES THE “SAVED” PROGRAM INTO CORE STARTING AT LOC 000000. 


GET DEV:FILNAM.EXT 
tc 
sant DKO: UPDATE. SAV 


NOTE: SAVE CORE IMAGE FILES (.SAV FILES) ARE NO 
LONGER IN USE, THE ” IS NO 
LONGER VERY USEFUL. IT HAS BEEN LEFT AS 
THE COMPLEMENTARY COMMAND FOR THE SAVE COMMAND. 


THE MOD COMMAND (UPD2TR) 


ONCE A PROGRAM IS LOADED IT CAN BE PATCHED BY THE MOD COMMAND. 


MOD ADR CAUSES UPDATE TO PRINT THE FOLLGWING: 
ADR CONTENTS OF ADR, 
AND WAITS FOR USER RESPONSE. 


THE USER MAY TYPE IN AN OCTAL NUMBER AND A TERMINATOR, OR JUST 
A TERMINATOR. 


IF A NUMBER IS TYPED, IT IS USED AS THE NEW CONTENT OF ADR. 

T TERBINGTOR Cony R A CARR TURN OR A LINE Fi 
cAI Ace Re Kes Fae ROGRAN BACK TO COMMAND M : WHEREAS 
ae NE FEED C CAUSES THE NEXT WORD (ADR+2) TO BE OPENED FOR 

#MOD SO 
0000S0 O0000S 3 <LF> 
0000S2 012737 4 <LF> 
000054 O00340 5 <CR> 
*#M0D SO 


SEG 0014 


TS TT ST eae hte SSS SS ee a 


4.12 


«LF > 

eh) 

THE MOD COMMAND WILL NOT ALLOW THE USER TO GO BEYOND THE PROGRAM’S 
PROTECTION LIMIT, AN “INVCOR” ERROR WILL OCCUR. (SEE SECTION 4.13) 
THE CORE COMMAND (UPD2TR) ¢ 


THE CORE COMMAND CAUSES THE LOWER AND UPPER LIMITS OF THE PROGRAM 
IN CORE TO BE TYPED: 


eee pot tT ENT NURBER TS THE UPPER CORE Li 


THE “LOCORE” COMMAND (UPD2TR) 


THE “LOCORE” COMMAND IS USED TO CHANGE THE LOWER LIMIT OF THE PROGRAM IN CORE: 
#LOCORE ADR<CR> ; T MIT. IT RECOMMENDE: 
, HHA pbpRese oe Loe CORE LIMI IS RECOMMENDED 





IT 
mrt. 


THE “HICORE” COMMAND (UPD2TR) 


THE “HICORE” COMMAND IS USED TO CHANGE THE UPPER LIMIT OF THE PROGRAM IN CORE: 


#HICORE ADR<CR> i ADRESS ADR B18 THE NEW HIGH core pol UA ait he Cnt THAT 
VEN, BUT MUST BE HIGHER T' THE LOWER 
;LIMIT, AND MUST'’BE LOWER THAN START OF F UPDATE PROGRAM. 


AvpROGRAn” THE UPOaTE Paocren ATLL Riv ALLOW ROBIFTCATTON Or CORE 


OUTSIDE Ti THE NEW fits 
MUST BE SET FIRST. ATHIS. PR PROTECTS THE CORE "OUTSIDE DE tHE PROGRAM FOR THE USER. 


THE DIRLP AND DIR COMMANDS 


*DIRLP DEV ;COMMAND FORMAT 

UPD2TR ONLY : 

“DIR DEV:#.BIN VE cToRy ALL FILES 
wet 2 BIREC ES ENSION. 

*DIR DEV:#.B1? jgives. A “DIRECTORY OF FILES 

XTENSION BEGINING WITH 

"aI i BNO AN OTHER CHARACTER 

DIR DEV:2TC???.BI? “GIVES A DIRECTORY OF ALL FILES 
WITH THE FIRST THREE CHARACTERS 
OF THE FILENAME BEING “ZTC” 


AND HAVING AN EXTENSION BEGINING 
WITH “BI”. EXAMPLES; ZTCA.BIN, 


SEQ 0015 


DOe2 


NOTE: AT THE END OF THE DIRECTORY THE EB Ee ako FREE aLocKs WILL BE 


INDICATED ONLY ON RANDOM ACCESS DEVICES. 


NOTE: DIR IN UPDATE #1 GIVES ONLY THE SHORT DIRECTORY (NO LENGTH, NO START). 


4.15 


4.16 


DIRLP CAUSES THE DIRECTORY OF DEV: TO PRINTED ON LINE PRINTER. IF 
DIR IS USED THE DIRECTORY IS TYPED ON CONSOLE DEVICE. DO NOT USE 
DIRLP UNLESS A A LINE PRI PRINTER EXISTS 8s NO. CHECK IS MADE FOR ITS 
L PROBABLY 


FILNAM .EXT DATE LENGTH aie 





1 2-AUG-72 14 000105 
5 S-Auc-? ooeoe 


000004 5 2-AUG-72 lec o00eee 
once FILES: 444 


LENGTH IS THE NUMBER OF BLOCKS (10) THE FILE OCCUPIES. A “C” AFTER 
THE FILE LENGTH INDICATES THE FILE IS CONTIGUOUS. 


START IS THE ADDR OF FIRST BLOCK OF FILE. OCTAL NUMBER. 
DATE IS THE FILE CREATION DATE. 


THE DELETE COMMAND (UPD2TR) 


DEL DEV:FILNAM.EXT 
CAUSES THE FILE NAMED TO BE DELETED FROM THE DIRECTORY. 


*#DEL DKO:1 
*DIR DKO: 


erat 76 

NTRY® FILNAM .EXT DATE LENGTH START 
e 2-AUG-7e lec 000172 
: S-Aue-? 186 

FREE FILES: 444 

THE ZERO COMMAND (UPD2TR) 


ZERO DEV: 


DESTROYS THE DIRECTORY. AS FAR AS UPDATE IS CONCENED: Lye IS 
NOTHING ON THE DEVICE. THIS SHOULD BE DONE ON A BRAND’ 

OR CARTRIDGE SINCE UPDATE USES THE ZERO COMMAND TO RESERVE "SOME 

ROOM FOR USE BY THE TROP MONITOR. VALID FOR ALL MASS STORAGE DEVICES. 


*#ZERO DKO: 
*#DIR DKO: 


SEQ C016 


4.17.1 


4.17.2 


4.18 


E02 


26-AUG-72 

FILNAM.EXT LENGTH START DATE 
FREE FILES: 448 

THE BOOT (UPD2TR) 

BOOT DEV: 


HE PROGRAM THEN JUMPS T 


CAUSES BLOCK 0 iS TO pe Loe Lonoer MEMORY, STARTING AT LOC — 
R. 


BLOCK 0 IS ASSUMED 
LOC 000000 TO START THE BOOT LOADE 


EXAMPLE : 
BOOT DKO:<CR> ;BOOTS IN THE RKDP MONITOR. 
BOOT MTO:<CR> ;BOOTS IN THE TROP MONITOR. 


SAVM DEV: #¥##%(( NOT USED IN UPD2TR ) )##### 


CAUSES THE FIRST 4K TO BE WRITTEN IN .SAV FORMAT (CORE IMAGE) 
or oe AT THE MONITOR CORE IMAGE BLOCK OF THE Ae 

THIS COMMAND IS USED TO WRITE THE TROP MONITOR ON THE 
DEVICE AS A CORE IMAGE THAT IS BOOTABLE. 


*#LOAD DK1:RKDP.BIN ;LOAD RKDP MONITOR. 
*#SAVM DKO: ;SAVE IT AS CORE IMAGE ON DKO: 


THE SAVM COMMAND IS VALID ONLY ON RANDOM ACCESS DEVICES. 
NOTE: SAVM IS NOT A DIRECTORY ENTRY IT WILL NOT SHOW 


ON DIRECTORY. 
THE RENAME COMMAND (UPD2TR)#####[( NOT USED ) ]##### 


#REN DEV: NEWNAM. EXT+DEV: OLDNAM. EXT 


RENAMES THE OLD FILE. THE DEVICES MUST BE THE SAME. NOT ALLOWED 
ON MAGTAPE OR CASSETTE. 


#DIR DKO: 
12-JAN-76 


ENTRY# FILNAM .EXT DATE LENGTH START 
000001 ASD -123 26-AUG-76 16C 000105 
FREE FILES: 447 


#REN DKO: 123. ASD+DKO:ASD. 123 
#0IR = DKO: 


SEQ 0017 


4.20 


FOe 


12-JAN-76 


ENTRY® FILNAM .EXT DATE LENGTH STAR 
123 - ASD 26-AUG 16C Bu010s 


000001 
FREE FILES: 447 


PIP COMMAND —CUPD2TR) 


PIP IS USED TO COPY A LINKED FILE FROM ANY DEVICE THAT CAN INPUT 
TO_ANY DEVICE THAT CAN PERFORM OUTPUT OPERATIONS. FILE DATA IS 
NOT CHECKED FOR FORMAT OR CHECKSUMS. 


PIP DEV1:FILNAM. EXT+DEVe: FILNAM. EXT 


PIP PP:+PR: » (COPIES PAPER TAPE) 
aPIP DKO:123.45b(PR:  ;PAPER TAPE 10 DISK 

*PIP PP: <DKD: 123.456 :DISK TO PAPER TAPE PUNCH. 
DIR DKO: 
ft fs til t date Sessth tart 
ntr e en $s r 
6o0081 i23 esd «= Be-aug-72 lée® 600105 
ooo002 1331456 Bb -aus-72 3 12 
sree files: 446 


SHOULD HAT THE OUTPUT FILE NAME DOESN’T EXIST 
ALREADY “OR OUTPUT Device DIRECTORY. 


PIP DKO: A+DKO:A ;1S A NO NO. 
DELOLD ;CAUSES THIS ERROR. DELETE OLD FILE 1ST. 


PIP HAS OTHER USEFUL FEATURES: 

PIP PP:+PR: COPIES A PAPER TAPE. 

important!!! 

a program that has been “pipped” to a TRdp device 
must be loaded immediate] fs the “load” command 
to insure that no errors Rave occurred during the 


“pip” command as the pip command does not checksum 
input data! 


THE “FILE” COMMANDS (UPD2TR) 


ere NCLUDES A GROUP OF aes WHICH CAN EXECUTE ON MULTIPLE 
FILES WITHOUT REQUIR xe The tere Or ER riLe TO BE COMERS, 


I 
LI IN THE “FI 

TACLUB IHG FILE. FI mais ne. rey AND Fie? 
THIS GENERAL DESCRIP Sih oe WILL Be BF tory bor 
EXPLAINED. NOTE ear , CAN NOT BE 
WITH NON-DIRECTORY The teSicH” AS ae pp 


USED 


SEG 0018 


GOe 


THE “FILE” COMMANDS RECOGNIZE TWO SPECIAL CHARACTERS IN THE FILE NAME 
CHARAC , THE ASTERISK (#) AND THE QUESTION- 
REFERENCE SEVERAL FILES. 


TE THAT FILE NAMES ARE ALWAYS RECORDED AS HAVING & CHARACTERS 
AND EXTENSIONS ALWAYS HAVE 3 CHARACTERS. THEY ARE LEPT-JUSTIF IED 
ING BLANKS ADDED, AND THE BLANKS ARE PART OF THE NAME 


WITH TRA OF 
FECOLBY THEIR TREATMENT OF ERROR CONDIT 1Tons SrouLD Be Ro TROTED Th 8 a 
DIRECTORY 1, REFERENCED TH THe GRSE OF DISK GR DECTAPE. “OR THE BLOCKS 
ARE IN THE A ESE i OR MAGTAPE) FHe “FILE” 

. IF A DEVICE ERROR, CHECKSUM 


TIVE INFORMATION ABOUT EACH 
FILE NAME, TRANSFER ADDRESS 
/N AND /LP’SWITCHES ARE INCLUDED 


BR 
% 
= 


AND LOCORE AND HICORE VALUES. + THE 
TO ALTER THIS IF DESIRED. 


THE “ASTERISK” CONSTRUCTION 


DESIRED agg Se FILENAME ) "Fo ALL FILES HAVING A DE 


DE PS ok VW eth ti HEE e Ga HE rll Beet 
POSITION MEANS “ANY EX 


TO REFER TO ALL FILES HAVING A DESIRED gps (ANY 
FILENAME), AN ASTERISK IS TYPED FOR THE FILENAME: 


DKO: #. OBJ we ALL_FILES ON DISK O WITH 
-OBJ EXTENSION 
DT3:#.P11 MEANS ALL FILES ON DECTAPE 3 WITH 


THE EXTENSION .P1l 


ie RerER oe PLL FILES WITe TH A we PEERED A? FILENAME (ANY EXTENSION), 


DKO: UPD2TR. # MEANS ALL an ON DISK O WITH THE 
FILENAME UPD2TR, SUCH AS UPD2TR.P11, 
UPD2TR.LST, AND UPD2TR. DOC 
DT1:SYSTST.# WE ONe fenane FILES DECTAPE 1 WITH 
ILENAME 


YSTST, SUCH AS 
SYSTST.V1,SYSTST.LST, AND SYSTST.OBJ 


ERE VGALER REE {BRE RE eo 


MT3:%.# MEANS ALL FILES ON MAGTAPE 3 
CTO: #.# MEANS ALL FILES ON CASSETTE 0 


SEQ 0019 


4.23 


4.24 


4.25 


THE “WILD CHARACTER” CONSTRUCTION 


5 
: 
: 
i 


T 
ain NAMES DIFFER IN SPE 


( BL 
TWO BLANKS, WITH A .DOC EXTENSION. 
UPD1.D0C AND UPD2TR:DOC WOULD BOTH QUALIFY. 
LUDE ANY 


DT1:TEST??.P11 WOULD INC FILES ON DT1 WHOSE FILENAMES 
GIN WITH pale veg PE ale ARE 
. i, SUCH AS TESTe.Pll, TEST34.P11, AND 


T 

CT1:SYSTST.V? I FILE ON CASSETTE 1 WHOSE FILENAME 
IS “SYSTST” AND WHOSE EXTENSION BEGINS WITH “V™ 

AND ENDS WITH A BL THUS, SYSTST.V1 AND 

SYSTST.VA WOULD GUA IFY, BUT SYSTST.V14 AND 


ag 
an 
3 


THE FILE COMMAND (UPD2TR) 


THE FILE COMMAND IS USED TO DO BULK TRANSFERS FROM ONE DEVICE 
ANOTHER. IT IS SIMILAR TO A PIP COMMAND EXCEPT THAT IT CAN UT 
THE THE “ASTERISK” AND “WILD CHARACTER CONSTRUCT TONS IF r: FILE OF 

UNLIKE THE PPG SO) UL ETE THE Seen a3 ALSO wa T 
I ca Sree Ee BOTH Ene OLD CONTIGUOUS (CORE- 
FILE DEV: <DEV:FILNAM. EXT COMMAND FORMAT 


WHERE THE DEVICE NAME ON THE LEFT IS THE OUTPUT DEVICE AND 
THAT ON THE RIGHT IS THE INPUT DEVICE. 


et 


THE FILEF COMMAND (UPD2TR) 


APE ALL T 
NTIALLY ONTO THE TAPE STARTING aT THAT 
MINATES THE CHECK OF TAPE 
DIRECTORY WHICH IS MADE BEFORE EACH FILE TRANSFER IF THE FILE COMMAND 


FOR RANDOM ACCESS DEVICES THE F IS TRANSFERED TO THE FIRST 
AVAILABLE SPACE ON THE DEVICE. 7 i - 


FILEF DEV:<DEV:FILNAM.EXT ;COMMAND FORMAT 


THE FILED COMMAND (UPD2ETR) 


SEG C020 


4.26 


4.27 


4.28 


4.29 


a Ide 


THE FILED COMMAND DELETES THE FILES NAMED FROM THE DEVICE’S DIRECTORY. 
FILED DEV:FILNAM.EXT ;COMMAND FORMAT 


UPD2TR NOW PERMITS THE USE OF THE DEL(ETE) COMMAND WITH * AND WILD CHARACTER 
FILENAME CONSTRUCTION. EXAMPLE: 


DEL DKO:#.BIN ;DELETES A ALL FILES IN DKO: WITH .BIN 
: EXTENSION 
CAUTION!!! THE UPD2TR PROGRAM DOES NOT wREQUIRE cHERIFICATION. OF A MASS 
SOE TFY Te THAT HE DOES, USOT REALL "TO occ 
IF IT SHOUL ORT ROL C WILL ALLY PER 1 
AT THE HORST 0 BPPSRTUN 
THE FILEL COMMAND (UPD2TR) 


i TT ASSUMES THAT A ALL’ REFERENCED, FILES. ARE ABS FORRET UIE fia: ap gece 


OR EOM ERROR HILL Oc 
FORMATTED FILES sais BE CORRECTLY LOADED (CHECKS FOR DEV VICE FAN 
CHECKSUM ERRORS). IF AN ERROR OCCURS, IT WILL IDENTIFY THE TYPE OF 
ERROR AND THE BeVIGE. 


FILEL DEV: FILNAM.EXT COMMAND FORMAT 
THE LOAD COMMAND MAY ALSO BE USED IN uPoaTR TO PERFORM THE SAME FUNCTIONS 
AS THE FILEL COMMAND. 


THE FILEG COMMAND (UPD2TR) 


THE FILEG (FILE GET) COMMAND IS SIMILAR TO THE FILEL COMMAND EXCEPT 
THAT IT LOADS AND CHECKS CONTIGUOUS (CORE-IMAGE) FILES INSTEAD OF 
ABS FORMAT FILES. DEVICE ERRORS AND SIZE ERRORS WILL BE REPORTED. 
FILEG DEV:FILNAM.EXT ;COMMAND FORMAT 


THE GET COMMAND MAY ALSO BE USED IN UPD2TR TO PERFORM THE SAME FUNCTIONS 
AS THE FILEG COMMAND. 


THE FILET COMMAND (UPD2TR) 


TO’ MaKe” CERTAIN THAT NO DEVICE ERRORS OCCUR. ANY DEVICE ERRORS ARE. 
[isteD AS THEY OC 

FILET DEV:FILNAM.EXT ;COMMAND FORMAT 

THE /LP AND /N SWITCHES (UPD2TR) 


CHECKED, T Me EE ce, AND LOCERE’ AND HICORE VALUES, 


SEQ 0021 


ee eee 


4.30 


4.31 


THE /LP SWITCH CAUSES THIS INFORMATION TO BE 


at TH ye gnats cant a EPSPS, Pernvouts Ae Gureur Su eves must 


; TEST ALL FILES ON DKO AND PRINT 
;THE FILE INFORMATION ERROR 
; INFORMATION ON THE LINE PRINTER 


FILEG DOT1:#.SA?/N 3089 GORE STAGE PAR OF ALL THE 


REPORTING ONLY ERROR INFORMATION 


:#.BIN’ : P T 
FILEL /N MT2:#.BIN’LP iRePoari ahd Eafon Ine ote 108 2, 


:#. TXT/LP ; TE ALL _.TXT FILES FROM 
oe ‘PRINT DELETED FILES ON LINE OBRINTER. 


(UPD2TR) 


FILET DKO:#. #/LP 


THE “EOT” COMMAND 


an ms anita IS PROVIDED AS A a - are a AN “END-OF-TAPE 
SENTINEL FILE AT A SELECTED SPO 


Eesti SPR e at Ses fiche em 


TILL BE ABLE T 
THOSE DELETED F Fits 

THE PROCEDURE TO BE USED IS AS FOLLOWS: 

A. POSITION THE MAGTAPE BY PERFORMING A FILET COMMAND ON THE FILE 


PRECEDING THE SPOT WHERE THE “EOT” IS 10 fe CL eeEY IN PRACTICE 
Beith” thee He HaT rte Roe bbecbilie MT? 
B. PERFORM AN “EOT” COMMAND. 
EXAMPLE : 
*FILET MTO:ZQRADO.BIN<CR> ;READS FILE ZQRADO.BIN AND STOPS. 
#E0T<CR> WRITES EOT. 


THE TEXT COMMAND 


UPD2TR INCLUDES THE FACILITY TO ty A FRENC E OF COMMANDS 
CONTAINED IN AN ASCII TEXT FILE. THIS ASCII TEXT FILE IS CREATED 
VIA THE TEXT COMMAND. ALSO SEE SECTION 4. XTECO TEXT EDITOR. 


TEXT DEV:FILNAM.EXT ;COMMAND FORMAT 
WHEN THE TEXT COMMAND IS ISSUED UPD2TR OPENS THE NAMED a FOR 
AND RE WITH A QUOTATION MARK (“) H 8 OTA ITS 
T XT. ANY ASC TER ( CONT . wo 


AS INPUT TO THE TEXT fie. TROL 
RETURNING TO COMMAND MODE AND CLOSING 

ILE. CONTROL 2 (#2) IS THE STANDARD TERMINATOR FOR INPUT 
TO THE TEXT FILE. RUBOUT CAN BE USED TO DELETE CHARACTERS ON THE 


(UPD2TR) 


SEQ 0022 


me ee 


4.32 


4.33 


4.34 


4.35 


K0e 


CURRENT LINE (BUT NOT ON PRECEDING LINES). 
POUND SIGN (#), THE SEMICOLON (; 


es ae Ceili ARE 


WHICH IS TO BE PRINTED 


rep iS “. rt 1s"USED 
DURING COMMAND FILE EXECUTION (SUCH AS “SPRESS CONT 


THE PRINT COMMAND (UPD2TR) 


THE in ten COMMAND _ A aay i THE +. Le PRINTER. Ag i 
TO PRINT TEXT FILES T TO THE LINE PR 


AND eh oe iO Sanaa Pe ERR ee aa 


CONSTRUCTION IN FILENAMES, SO 
THAT MULTIPLE. TEXT APTLES NAY BE P BE PRINTED WITH ONE COMMAND. 


PRINT DEV:FILNAM.EXT ;COMMAND FORMAT 
PRINT DEV: #. TXT 

WHERE DEV IS THE SOURCE DEVICE ON WHICH THE FILE RESIDES. 
NOTE THAT NO CHECK IS MADE OF FILE PRINTABILITY. 


THE TYPE COMMAND (UPD2TR) 


SANE AS THE PRINT COMMAND EXCEPT THAT IT OUTPUTS TO THE CONSOLE 


TYPE DEV:FILNAM. EXT ;COMMAND FORMAT 
THE DO COMMAND (UPD2TR) 


EE ASTER PE aS SORE ES 


OR DISK) THE Rains ods EXECUTED LINE BY LINE 
ILES RE CR CREATE 


nf i et x gree at pa Ps OR FeRGSEETION 


HE PRECEEDING COMMAND DESCRIP 
DO DEV:FILNAM. EXT ;COMMAND FORMAT 


THE ASG (ASSIGN) COMMAND (UPD2TR) 


THE ASG (ASSIGN) COMMAND ALLOWS THE USE 
yet! FILES. ALLOWED LOGI CE 


ECIFYING, FOR E mit facta ten he BProke ¢ 
COMMAND FILE I 


SEQ 0023 


<a ae ee ee ee +. 


4.37 


LOe 


ASG PHYSICAL DEV = LOGICAL DEV sCOMMAND FORMAT 
RES TET IN“ TNVBEW™ERNOR. RESSAGE.- THE COMMEND. 1S NOT PERFORMED 


ASG DKl1: = 2:  ;ASSIGNS DISK 1 TO LOGICAL DEVICE “e” 
ASG DT3: = SYS: ;ASSIGNS DECTAPE 3 TO LOGICAL DEVICE “SYS” 


THE PATCH COMMAND (UPD2TR) 


ORIENTED “(RANDOM ACCESS). TROP SUPPORTED GEVICE™ NG OUTPUT On 


DEV: FILE SPECIFICATION IS REQUIRED OR PERMITTED, THE INPUT DEVICE 
TS ASSUMED TO BE THE DESIRED OUTPUT DEVICE. 


Me ma {52 TO BE PATCHED UST Be IN Aas (oat 

THE PATCH ROUTINE DOES NOT CHECK IN ADVANCE 
FOR CO CORRECT FILE FORMAT THE FOLLOWING EXTENSION 
ARE FOR TROP ABS FORMAT FILES; .BIN, .BIC, . 


CARRIAGE-RETURN OR bine -rreD ARE_THE ONLY CHARACTERS WHICH MAY BE USED 


CpOVARICES KEY, WITCH BILL GD 10 THE er fue RUBOUT- KEY MAY 


T KEY 
BE USED TO rcobRecT Ty woe MISTAKES MADE ON INPUT. ALL ADDRESSES ENTERED MUST 
BE EVEN. IF AN S TYPED (IN RESPONSE 70 A PROMPT) WHICH IS ODD, THE 
PROMPT WILL ut Be RECREKED. 


BEING OPERATED UPON. t os Hag Ne Five SPECIFIED ADRESS MILL 
BE INDICATED BY L THEN GIVE THE USUAL “2” 
PROMPT, ASKING. 1F ROT MODIFICATION 18 DESIRED 


THE OUTPUT 

INTO THE SPECIFIED FILE. 

ff A LENGTH OF ¥5 Moe MODIFIED BY THE USE OF THE “PATCH” COMMAND DATE AND 
FILE OPERATED UPON ARE UPDATED IN THE BEVICE D DIRECTORY AS 


IF THE FILE BEING PATCHED CONTAINS NTATIONS OF ISOLATED SINGLE-BYTE 
DATA, of Aeon THOSE GENERATED BY y THE FOLLOWING RESERBLY 
 ] 


A. 224 

-BYTE 120 

-EVEN ;GENERATES ONLY 1 BYTE OF DATA 
B =413 


ee ee ee oe | + oe 


SE@ 0024 


DEVFUL 


INVCOR 


Oe 


;GENERATES ONLY 1 BYTE OF DATA 


;GENERATES ONLY 1 BYTE OF DATA 


POLES ieee aN We ie WILL BE PROPERLY 
He ROJACENT DATA 
FOR 


TED TO BE 0’S et T REPRESENTED IN THE FILE. 
A REOVE, 


Brie WHICH OCCUPIES THE SANE WORD AODRESS HILL BE 


IN THE CASE 
<CR> 
ttt---- NOTE THAT THE CONTENTS OF THE 
UPPER BYTE ARE ACTUALLY UNKNOWN 


ADDR? 412 <CR> 
Ooo 8 177400 


tt----NOTE UNKNOWN DATA _IN LOW BYTE 
REPRESENTED BY 0’S. 


INVALID COMMAND. CHECK COMMAND JUST GIVEN. 
INVALID DEVICE SPECIFIED FOR COMMAND GIVEN. 


acipoqnd nin fendenglindein ANSUPDATE. PROGRAM. 
INVALID FILE NAME. NO SPE 


ALSO OCeURS' IF # OR EAE She REG Ele 


ARE SPECIFIED TO A COMMAND THA 


NON-EXISTENT FILE. FILE DOES NOT EXIST IN DEVICE DIRECTORY. 


PELETE OLD FI nee ore GIVING COMMAND THAT WOULD CREATE 


DEVICE ERROR ON EITHER INPUT OR OUTPUT DEVICE. CHECK 
THAT OUTPUT DEVICE IS WRITE-ENABLED. 


PAPER TAPE DEVICE IS NOT READY. MAKE IT READY. 
CHECKSUM ERROR DURING “LOAD” COMMAND. 

END OF MEDIUM. OCCURS DURING INPUT OPERATIONS WHEN THE 
PROGRAM ATTEMPTS TO our AND THE FILE IS AT AN END. 
SERIOUS S PROBABLY WIPED OUT. 
REFER TO SECTION 4 FOR MEDIUM TESTING COMMANDS. 

DEVICE FULL. APPLIES TO DECTAPE AND DISK. NO MORE FILE 
STORAGE AVAILABLE. DELETE UNNECESSARY FILES AND TRY 
AGAIN, OR USE ANOTHER MEDIUM. 


HIGH CORE LIMIT LOWER THAN LOWER CORE LIMIT. CORRECT 


SEQ 0025 


j 
—— | 


mm ee 


5.1 


6.1 


N02 


CORE LIMITS. OCCURS DURING DUMP COMMAND. 

DIRERR INVALID NAME IN DEVICE DIRECTORY. 

~~ RAT (BGaE OAC eSUPAEB On Bae BEER LEPE CUP. *TRARSFER 
FILES TO OTHER MEDIUM. (SEE SECTION 4.). 

POFLOW PROGRAM TOO LARGE TO LOAD WITHIN EXISTING CORE SPACE. 

INVSW INVALID SWITCH SPECIFIED IN COMMAND STRING. 

DUMP ERROR ACT MODE ONLY core SECTION 7). OCCURS DURING DUMP 
——— wor DATA DUMPED ON OUTPUT DEVICE DOES NOT MATCH 


ERRORS UNIQUE TO THE FILCMP COMMAND 


UNEQUAL FILE TYPES INDICATES THE TWO FILES BEING COMPARED 
ARE NOT OF SIMILAR STRUCTURE. 
UNEQUAL FILE SIZES INDICATES THE TWO FILES BEING COMPARED 


ARE NOT THE SAME SIZE. 


SCRATCH FILE SHOR 
“ —— MASTER EE cRATCH FILE IS THE FILE ON THE 


oe eee THE LEFT OF THE 
BACK ARROK IN THE COMMAND STRING. 


TCH F 
SCRATCH FILE LONGER THAN MASTER Fie scnaroy FILE WHICH IS ON THE 
T OF THE BACK ARROW IS LONGER 


THAN THE FILE 
BLOCK COMPARE ERROR XTH BLOCK, Bey TE 
ERROR OCCURRE 


ON 
; 
NUMBER AND BY BYTE NUMBER WHERE THE 


UPDATING TROP MEDIA 


UPDATING TROP MEDIA CONSISTS OF: 


A. PATCHING EXISTING PROGRAMS (DEPO) 
B. REPLACING WITH NEWER VERSIONS, OR 
C. ADDING NEW PROGRAMS. 


Fake EXTRA oURe THAT A BACKUP FOR THe HeBIUN 10” 


BE MODIFIED EXISTS, IN ORDER ABLE TO RE woe ram FATAL ERRORS. 
(ZEROING THE MEDIUM, DELETING. THE WRONG FILE, ETC. 


PATCHING EXISTING PROGRAMS 


PATCHING A PROGRAM IN A TROP MEDIUM CONSISTS OF: 


ee ae wn ee we ee oe - 


SEQ 0026 


EEE EEE 


3014 


Nm mn 


6.2 


BO3 
Foe Giclee 


FIED PRO BROGAER (OUMP ). 
STORE THE PATCHED PROGRAM FIRST, 

feo THEN eeTER TRY! TRYING nF me arme THE OLD PROGRAM WOULD 

EXAMPLE: 

tc 

#LOAD MTO:DOSA0.BIN (LOAD PROGRAM) 

#MOD (MODIFY PROGRAM) 

0034S0 012737 oD0000 


*DEL MTO:DOSAD.BIN (DELETE OLD 
xOUNE NTO: DOSAl . BIN (STORE MODIFIED PROGRAM) 
“START — ( out NEW PROGRAM) 


200 
IT IS IMPORTANT WHEN IMPLEMENTING gt THAT THE NAME OF THE 
HE PROGRAM. SEE APPENDIX D. 


TO REPLACE A PROGRAM, OR TO ADD A NEW ONE: 


DELETE OLD PROGRAM IF REPLACING IT, 
s LOAD NEW PROGRAM INTO MEMORY, 
: BUMP PROGRAM ONTO DEVICE. 


EXAMPLE 1: 

*DEL_MTO:DOSA1.BIN (DELETE OLD PROGRAM) 

a PR: (LOAD NEW PROGRAM ) 
=LOAD RTO: DOSB0. BIN (ORD NE PROGRAN) 

ESTART 200 (TRY NEW PROGRAM) 

EXAMPLE 2: ° 


DEL MTO:00SA1.BIN PROGRAM. 
LOAD PR: ; LOADS NEW PROGRAM FROM PAPER TAPE. 
DUMP MTO:DOSBO. BIN DS NEW 


LOAD MTO:D0S80.BIN CHECKS THAT PROGRAM LOADS CORRECTLY. 


NOTE: DELETING A PROGRAM FROM CASSETTE OR reg DOES NOT POSTCRLLY 
REMOVE i PROGRAM FROM THE MEDIUM. IT STILL TAKES UP SPACE. 

CLEAN UP THE CASSETTE OR MAGTAPE, IT MUST BE COPTED VIA ITS TROP 
MONITOR’S COPY ROUTINE, WHICH COPIES ONLY “GOOD” FILES. 


;DELETES OLD 


SEG 0027 


ee a 


0015 


H 
ee | 


ss ee © eee 


6.3 


6.3.1 


6.3.9 


CO3 


#PIP MTO:OVLY.BIN¢PR: (PIP TO MTO: — PR: ) 
#LOAD MTO:OVLY.BIN (LOAD OVERLAY 


N The EREOR DIRECTLY TO A GEvice 
Te Taper, 1, Theor NOT Tear 38 enon DATA. nie ScuRRED 
GENERATING A TROP MEDIUM 


Thode PROGRARS REQUIRED 10 TEST A PARTICULAR SYSTEM. As AN EXAMPLE, 
SUCH A MEDIUM COULD CONTAIN: 


A. PROCESSOR TESTS 
B. MEMORY TESTS 
C. 1/0 PROGRAMS FOR THAT SYSTEM 


WITH SUCH A MEDIUM, THE ENTIRE SYSTEM COLD BE_TESTED USING THE 
CHAIN MODE OF OPERATION, WITHOUT HAVING TO SWITCH DECTAPES. OR CASSETTES. 


THE PROCEDURES FOR GENERATING A NEW MEDIUM FOLLOW. 


CREATING A NEW TROP MAGTAPE 


A. MOUNT “NEW” MAGTAPE ON DRIVE OG 
B. PERFORM THE FOLLOWING COMMANDS: 


FOR A TR79F 


ROP. 
LOAD DKO:UPOTR.BIN 
DUMP MTO:UPOTR.BIN 


CREATING A TROP MEDIUM - COMMON PROCEDURE 


ONCE THE MONITOR HAS BEEN SAVED ON THE MEDIUM, UPD1.BIN AND UPD2TR.BIN 
SHOULD BE SAVED: 


FILEF DEV1:<DEVO:UPD?.BIN ; TRANSFERS UPD1.BIN AND UPD2TR.BIN 


CONTIGUOUS (CORE-IMAGE) FILES SHOULD BE TRANSFERRED NEXT (TO GUARANTEE 
ROOM ON THE MEDIUM). THIS CAN BE DONE VIA THE FILEF COMMAND: 


FILEF DEV1:<DEVO:A. SAV ; TRANSFER A. SAV 


FROM THIS — ON, THE DESIRED PROGRAMS ARE TRANSFERRED FROM THE 
INPUT MEDIA TO THE OUTPUT MEDIUM VIA THE FILEF COMMAND. USE OF THE 
SPECIAL FERTLRES CAN CONSIDERABLY DECREASE THE NUMBE OMMANDS 
REQUIRED. FOR EXAMPLE, TO TRANSFER ALL DECTAPE DIAGNOSTICS TO THE 


SEQ O02 


D016 


eee 


DO3 


NEW MEDIUM A SINGLE FILEF COMMAND WILL SUFFICE: 


FILEF DEV1:<DEVO:XTC???.# ; TRANSFERS ALL PROGRF 1S 
;NAMES START WITH “Xi.” 


THE aire tee Dove pve Sep sroneD 8 Se ee 
at TESTED VIA FILET, FILEL, AND FILEG COMMANDS: 


FILET DEV1:#.#/LP sR 00 ENERY FAL maT TON ON Tee MEDIUM, 


Cine BRINTER 


FILEL DEV1:#.B81?/N *LOAD ALL ABS FORMAT FILES 
i10 VE VERIFY THAT BT NO _ERRORS 


3 OCCUR 
FILEG DEV1:#.SA?/N ete sees ies TO 
IT IS ALSO A GOOD IDEA TO DUPLICATE THE NEW MEDIUM TO PROVIDE A 
BACKUP. 


APPENDIX B. UPD2TR PROGRAM COMMANDS 


FILL<CR> SETS UP TERMINAL FOR CORRECT PRINT 
AFTER CRLF. 
CLR<CR> CLEARS CORE BELOW UPDATE PROGRAM 
XFR<CR> PERMITS MAKING PROGRAM SELF-STARTING, 
OR NON SELF-STARTING. 
DUMP DEV:FILNAM.EXT WRITES MEMORY CONTENTS IN ABS FORMAT 
LOAD DEV:DILNAM.EXT LOADS ABS FORMAT PROGRAM (.BIN, .BIC) 
PIP DEV1:FILNAM.EXT+DEV2:FILNAM.EXT COPIES FILE FROM ONE DEVICE TO ANOTHER. 
SAVE DEV:FILNAM. EXT WRITES MEMORY CONTENTS ONTO CONTIGUOUS BLOCKS 
GET DEV:FILNAM.EXT LOADS CORE IMAGE PROGRAM 
MOD ADR MODIFIES CORE CONTENTS 
CORE TYPES PROTECTION LIMITS 
LOCORE ADR _ ENTERS LOW PROTECTION LIMIT 
HICORE ADR ENTERS HIGH PROTECTION LIMIT 
DIR DEV: TYPES DEV DIRECTORY ON TTY 
DIRLP DEV: TYPES DEV DIRECTORY ON LINE PRINTER. 
DEL DEV:FILNAM.EXT DELETES FILE FROM DEV DIRECTORY 
ZERO DEV: . ZEROES DEVICE DIRECTORY 


BOOT DEV: LOADS BLOCK O OF DEV STARTING AT LOC 900000 


SEQ o02¢ 


1017 


SAVM DEV: 
START 
START ADR 
ACT 
NOTACT 


FILE DEV: <DEV:FILENAM.EXT 


FILEF DEV: <DEV:FILNAM.EXT 
FILET DEV:FILNAM.EXT 
FILEL DEV:FILNAM.EXT 
FILEG DEV:FILNAM.EXT 


FILED DEV:FILNAM.EXT 
FILCMP DEV: <DEV:FILNAM.EXT 


PATCH 
TEXT DEV:FILNAM.EXT 


PRINT DEV:FILNAM.EXT 


TYPE DEV:FILNAM.EXT 
DO DEV:FILNAM. EXT 
ASG PHYSICAL = LOGICAL 


EOT 
PATCH DEV:FILNAM.EXT 


FILCMP DEV: =DEV:FILNAM.EXT 


tC (CONTROL C) 


WRITES 4K ONTO DEV STARTING AT BLOCK 30 
STARTS PROGRAM AT LOC 000000 

STARTS PROGRAM AT ADR 

PUTS UPD2TR PROGRAM IN “ACT MODE” 

TAKES UPD2TR PROGRAM OUT OF “ACT MODE” 


Ber ORE borne THe TRARGFER 
SAME AS FILE EXCEPT THAT WITH CASSETTE OR 
MAGTAPE FAST TRANSFERS ARE PERFORMED (NO DIR CHECKING) 


READS FILE AND os FOR DEVICE 
ERRORS (FILE “TES 


LOADS FILES (ASSUMES ABS FORMAT) 
CHECKING FOR DEVICE AND CHECKSUM ERRORS 


LOADS FILES (ASSUMES CONTIGUOUS FORMAT) 
CHECKING FOR DEVICE AND FILE SIZE ERRORS 


DELETES NAMED FILES 


COMPARES TWO FILES AGAINST 
EACH OTHER ON TWO TROP MEDIUMS. 


THE USER TO PATCH A 


CREATES TEXT FILE FOR PRINTING 
OR FOR COMMAND EXECUTION 


OUTPUTS A FILE TO THE LINE PRINTER 
(ASSUMES IT ENDS WITH A 2) 


OUTPUTS A FILE TO THE CONSOLE TERMINAL 
EXECUTES A COMMAND FILE. 


ASSIGNS A PHYSICAL DEVICE TO A 
LOGICAL DEVICE NAME 


WRITES END OF TAPE MARK (FILE) ON MAGTAPE 
OR CASSETTE AFTER TAPE HAS BEEN POSITIONED. 


ENABLES PATCHING CAPABILITIES 
TO A FILE ON THE TROP MEDIA. 


COMPARES TWO FILES WITH 
EACH OTHER. 


RETURNS TO COMMAND MODE (OPEN OUTPUT FILE 
IS CLOSED). 


SE@ 0030 


018 


tZ (CONTROL 2) ENDS INPUT TO A TEXT FILE 


* USED FOR FILE NAMING TO MEAN “ANY” 
(ANY FILE NAME OR ANY FILE EXTENSION) 
’ USED FOR 4;-* NAMING TO INDICATE A WILD 
CHARACTER (ANY CHARACTER WILL MATCH IT) 
8 OR ; N_A FILE OF EXECUT 


ABLE COMMANDS 
1 § TART A eb NT hI ON WHICH IS TO 
3 SAME AS # BUT CAUSES A HALT AFTER 
THE COMMENT IS PRINTED 
APPENDIX C. PERIPHERALS SUPPORTED BY UPDATE PROGRAMS 


TROP SUPPORTS OR WILL SUPPORT THE FOLLOWING DEVICES: 


PR: PC11 HIGH SPEED PAPER TAPE READER (UPD2TR) 
PP: PC11 HIGH SPEED PAPER TAPE PUNCH (UPD2TR) 
KB: TTY KEYBOARD, OR LOW SPEED READER (UPD2TR) 
PT: TTY PRINTER AND PUNCH (UPD2TR) 


DKN: RK11/RKOS DISK (UPD2TR, N=0-3) 
MTN: TR79F MAGTAPE 3 TRACK (UPD2TR, N=0) 


CTN: TALI CASSETTE (UPD2TR, N=0 OR 1). 
APPENDIX D. PROGRAM NAMING CONVENTIONS 


THE FOLLOWING PROGRAM NAMING CONVENTION HAS BEEN USED FOR TROP. 

ITS USE WILL PERMIT USERS TO DETERMINE BOTH THE VERSION, AND THE 
MCN LEVEL OF THE STORED PROGRAMS. CONTINUED USE OF THIS SCHEME WHEN 
PROGRAMS ARE UPDATED IN THE FIELD IS HIGHLY RECOMMENDED. 


D 2FPKAS 

: *ttttt 

I II III 

I II III----- # = INDICATES MCN LEVEL 

I II II 0 = INDICATES NO MCN ISSUED 

I II II----- “A THRU Z = REVISION DESIGNATION 

{ | beeen 3 Tes: AY PES TGNATION 

{ Si ceieiae:  oterrs = OPTION Des Brier Tuet s 

I [oooooonne “A = 11705,15 

I B= ll BBaeeccor 

I C= 11 PRocEecon 

; Z = ALL S$ 

[------------------ D INDICATES A DIAGNOSTIC PROGRAM, AND IS NOT USED 
IN NAMING A PROGRAN. 


-BIN EXTENSION USED TO STORE PROGRAM IN ABS FORMAT. 


SEQ 0031 


019 


EE SS ee 


G03 


.SAV EXTENSION USED TO STORE PROGRAM IN CORE IMAGE FORMAT. 
-BIC EXTENSION INDICATES ABS FORMAT CHAINABLE PROGRAM. 


F. HELP ASCII REDRENCE FILE 


THIS FILE nn TO THE wonky DISTRIBUTION 


The FILE CAN BE TYPED/PRINTED OUT BY USING STANDARD 


* DETAILED CMM’D DISCRIPTION REFRENCE TROP USER MANUAL M-11-DMQXA 


TROP RESIDENT MONITOR COMMANDS 


F<CR> SET CONSOLE FILL COUNT 

D<CR> DIRECTORY ON THE TTY CONSOLE 
D/F<CR> SHORT DIRECTORY ON THE TTY CONSOLE 
D/L<CR> DIRECTORY ON THE LINE PRINTER 

b/ /F<CR> parr D ORY of INE PRINTER 


C FILENAME<CR> RUNS DESIRED CHAIN 
C FILENAME/QV<CR> RUNS BeSIRED CHAIN IN QUICK VERIFY 


XXDP RESIDENT MONITOR ERRORS 


INVCMD/SW INVALID COMMAND AND/OR SWITCH, CHECK COMMAND JUST GIVEN. 
DEVERR DEVICE ERROR ON INPUT DEVICE. 
Be SSR Ses OUNCES HE 
nae . FILE IN STORAGE fs OBABLY 
INVADR INVALID ADDRESS. MUST - EVEN. 
CKSMER CHECKSUM ERROR DURING COMMAND. 
Sean INVALID nee LARGE TO LORD HITHIN AVAILABLE CORE SPACE. 
NEXF IL NONCEXISTENT PILE FILE DOES NOT EXIST ON MEDIUM 
UPD2 PROGRAM COMMANDS 
FILL<CR> SETS UP TERMINAL FOR CORRECT PRINT 
CLR«<CR> CLEARS CORE BORE BELOW UPDATE PROGRAM 
XFR<CR> Fehrs. RACINE Pe PROGRAM SELF-STARTING, 
DUMP DEV:FILNAM.EXT ADR MRuTES As 1m CONTENTS. om "BIN rome 
B80 DEV: BIC) 


4 ILNAM. EXT 
SAVE EV:FILNOMEXT AOR re ied cn aE hy Tails BLOCKS 
GET ev:F1 LNAM.E CONTIGUOUS BLOCKS INTO MEMO 


SEQ 0032 


NOTACT 
FILE DEV: <DEV:FILENAM. EXT 


FILEF DEV: <DEV:FILNAM.EXT 
FILET DEV:FILNAM.EXT 
FILEL DEV:FILNAM.EXT 
FILEG DEV:FILNAM.EXT 


FILED DEV:FILNAM.EXT 
TEXT DEV: FILNAM.EXT 


PATCH DEV: FILNAM.EXT<CR> 
PRINT he FILNAM.EXT 


ILNAM. EXT 
ASG PHYSICAL = LOGICAL 
EOT 


tC (CONTROL C) 
tZ2 (CONTROL Z) 


HO3 


ENT LOW STON ON LORI 


BBS BIREEISE 8 ne ene. 


DELETES FILE FROM DEV 


ZERO IRECT 

L BLO B BF Bs STARTING AT LOC 00000 
WRITES 4K ONTO DEV STARTING AT BLOCK 30 
STARTS AT I ADDRE 
pears eat ADR 


BF Fa Sl ONE Device TO 
BEFORE ORE BOING THE TRANSFER 


Rane? Ft Heder ACERT ton ccc 


READS FILE AND CHECKS FOR DE 
ERRORS (FILE “TEST™) 
FILES (ASSUMES ABS FORMA 


ee ee ie eo 


AND FILE SIZE ERRORS 


MARK (FILE) ON MAGTAPE 
TER TAPE “_— BEEN POSITIONED. 
(OPEN OUTPUT FILE IS CLOSED). 


Es 


HIGH iO TO 


= 
r=) 
m 
oae 
S fasna"9 


+z : 
m Cre 
oD “++ —- 
+z 


E 
BEFORE GIVING COMMAND 
THER INPUT OR OUTPUT DEVICE 


SE@ 0033 


21 


103 


NOTRDY en T ICE IS NOT READY 
CKSHER CHE SUM 
EON END OF MEDIUM 
DEVFUL pen cone FULL 
INVCOR HIGH CORE LIMIT LOWER. Wes Loe CORE LIMIT 
DIRERR [yi [ike D NAME IN orex 
OlW Progra 100 eal eye TE Oper EXISTING CORE 
INVALID sir T D_IN COMMAND 


I 
DUNP ERROR ACT MODE ONL DUMPED ON OUTPUT DEVICE DOES NOT MATCH 


PR: PC1l HIGH SPEED PAPER TAPE READER (UPD2) 
PP: PC11 HIGH SPEED PAPER TAPE PUNCH (UPDe2) 
KB: TTY SEO ane LOW SPEED READER (UPDe) 
PT: TTY PRINTER PUNCH ) 
ad RK11/RKOS DISK (UPDe, N=0-3) 

> J 


CREATING A NEW XXDP MAGTAPE (TR79F) 


SEG 0034 


JO3 


me ee es rn ee em re 
. 


